home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / programm.ing / rcs56.zoo / rcs / man / rcsclean.txt < prev    next >
Encoding:
Text File  |  1992-01-26  |  3.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. RCSCLEAN(1)        Printed December 19, 1991          RCSCLEAN(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      rcsclean -    clean up working files
  10.  
  11. SYNOPSIS
  12.      rcsclean [options]    [ file ... ]
  13.  
  14. DESCRIPTION
  15.      rcsclean removes working files that were checked out and
  16.      never modified.  For each file given, rcsclean compares the
  17.      working file and a    revision in the    corresponding RCS file.
  18.      If    it finds a difference, it does nothing.     Otherwise, it
  19.      first unlocks the revision    if the -u option is given, and
  20.      then removes the working file unless the working file is
  21.      writable and the revision is locked.  It logs its actions by
  22.      outputting    the corresponding rcs -u and rm    -f commands on
  23.      the standard output.
  24.  
  25.      If    no file    is given, all working files in the current
  26.      directory are cleaned.  Pathnames matching    an RCS suffix
  27.      denote RCS    files; all others denote working files.     Names
  28.      are paired    as explained in    ci(1).
  29.  
  30.      The number    of the revision    to which the working file is
  31.      compared may be attached to any of    the options -n,    -q, -r,
  32.      or    -u.  If    no revision number is specified, then if the -u
  33.      option is given and the caller has    one revision locked,
  34.      rcsclean uses that    revision; otherwise rcsclean uses the
  35.      latest revision on    the default branch, normally the root.
  36.  
  37.      rcsclean is useful    for clean targets in Makefiles.     See also
  38.      rcsdiff(1), which prints out the differences, and ci(1),
  39.      which normally asks whether to check in a file if it was not
  40.      changed.
  41.  
  42. OPTIONS
  43.      -ksubst
  44.       Use subst style keyword substitution when retrieving
  45.       the revision for comparison.    See co(1) for details.
  46.  
  47.      -n[rev]
  48.       Do not actually remove any files or unlock any
  49.       revisions.  Using this option    will tell you what
  50.       rcsclean would do without actually doing it.
  51.  
  52.      -q[rev]
  53.       Do not log the actions taken on standard output.
  54.  
  55.      -r[rev]
  56.       This option has no effect other than specifying the
  57.       revision for comparison.
  58.  
  59.      -u[rev]
  60.  
  61.  
  62.  
  63. Page 1                     TARGON /35     Operating System
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RCSCLEAN(1)        Printed December 19, 1991          RCSCLEAN(1)
  71.  
  72.  
  73.  
  74.       Unlock the revision if it is locked and no difference
  75.       is found.
  76.  
  77.      -Vn  Emulate RCS version n.  See co(1) for    details.
  78.  
  79.      -xsuffixes
  80.       Use suffixes to characterize RCS files.  See ci(1) for
  81.       details.
  82.  
  83. EXAMPLES
  84.       rcsclean  *.c     *.h
  85.  
  86.      removes all working files ending in .c or .h that were not
  87.      changed since their checkout.
  88.  
  89.       rcsclean
  90.  
  91.      removes all working files in the current directory    that were
  92.      not changed since their checkout.
  93.  
  94. FILES
  95.      rcsclean accesses files much as ci(1) does.
  96.  
  97. ENVIRONMENT
  98.      RCSINIT
  99.       options prepended to the argument list, separated by
  100.       spaces.  A backslash escapes spaces within an    option.
  101.       The RCSINIT options are prepended to the argument lists
  102.       of most RCS commands.     Useful    RCSINIT    options    include
  103.       -q, -V, and -x.
  104.  
  105. DIAGNOSTICS
  106.      The exit status is    zero if    and only if all    operations were
  107.      successful.  Missing working files    and RCS    files are
  108.      silently ignored.
  109.  
  110. IDENTIFICATION
  111.      Author: Walter F. Tichy.
  112.      Revision Number: 1.8; Release Date: 1991/11/03.
  113.      Copyright O 1982, 1988, 1989 by Walter F. Tichy.
  114.      Copyright O 1990, 1991 by Paul Eggert.
  115.  
  116. SEE ALSO
  117.      ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsintro(1),
  118.      rcsmerge(1), rlog(1), rcsfile(5)
  119.      Walter F. Tichy, RCS--A System for    Version    Control,
  120.      Software--Practice    & Experience 15, 7 (July 1985),    637-654.
  121.  
  122. BUGS
  123.      At    least one file must be given in    older Unix versions that
  124.      do    not provide the    needed directory scanning operations.
  125.  
  126.  
  127.  
  128.  
  129. Page 2                     TARGON /35     Operating System
  130.  
  131.  
  132.  
  133. ə